home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Skunkware 5
/
Skunkware 5.iso
/
man
/
cat.1
/
xscreensaver-command.1
< prev
next >
Wrap
Text File
|
1995-07-25
|
7KB
|
199 lines
XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333)))) XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
NNNNAAAAMMMMEEEE
xscreensaver-command - control a running xscreensaver
process
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
xxxxssssccccrrrreeeeeeeennnnssssaaaavvvveeeerrrr----ccccoooommmmmmmmaaaannnndddd [-activate] [-deactivate] [-cycle]
[-next] [-prev] [-exit] [-restart] [-demo] [-lock]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The _x_s_c_r_e_e_n_s_a_v_e_r-_c_o_m_m_a_n_d program controls a running
_x_s_c_r_e_e_n_s_a_v_e_r process by sending it client-messages.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
_x_s_c_r_e_e_n_s_a_v_e_r-_c_o_m_m_a_n_d accepts the following options:
----aaaaccccttttiiiivvvvaaaatttteeee
Tell the screensaver to turn on immediately (that
is, pretend that the user been idle for long
enough.) It will turn off as soon as there is any
user activity, as usual.
It is useful to run this from a menu; you may wish
to run it as
sleep 5 ; xscreensaver-command -activate
to be sure that you have time to remove your hand
from the mouse before the screensaver comes on.
----ddddeeeeaaaaccccttttiiiivvvvaaaatttteeee
Tell the screensaver to turn off, as if there had
been user activity. If locking is enabled, then the
screensaver will prompt for a password as usual.
----ccccyyyycccclllleeee Tell the screensaver to change which graphics hack
it is running, just as if the ``cycle'' timer had
expired.
----nnnneeeexxxxtttt This is like either -_a_c_t_i_v_a_t_e or -_c_y_c_l_e, depending
on which is more appropriate, except that the
screenhack that will be run is the next one in the
list of programs, instead of a randomly-chosen one.
This option is good for looking at a demo of each of
the screensavers currently available. You might
want to put this on a menu.
----pppprrrreeeevvvv This is like -_n_e_x_t, but cycles in the other
direction.
----ddddeeeemmmmoooo Cause the screensaver to enter its interactive demo
mode, if it has been compiled with support for it.
Page 1 (printed 6/30/95)
XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333)))) XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
----lllloooocccckkkk Like -_a_c_t_i_v_a_t_e, but a password will be required
before the screensaver turns off, even if the
screensaver's _l_o_c_k resource is false. The display
will be locked immediately even if the screensaver's
_l_o_c_k_T_i_m_e_o_u_t resource is non-zero.
----eeeexxxxiiiitttt Causes the screensaver process to exit gracefully.
This is a slightly safer way to kill the screensaver
than by using _k_i_l_l.
Never use _k_i_l_l -_9 with _x_s_c_r_e_e_n_s_a_v_e_r while the
screensaver is active. If you are using a virtual
root window manager, that can leave things in an
inconsistent state, and you may need to restart your
window manager to repair the damage.
----rrrreeeessssttttaaaarrrrtttt
Causes the screensaver process to exit and then
restart with the same command line arguments. This
is a good way of causing the screensaver to re-read
the resource database.
If the screensaver is run from _x_d_m(_1) (that is, it
is already running before you log in) then you may
want to issue the ``restart'' command from one of
your startup scripts, so that the screensaver gets
your resource settings instead of the default ones.
EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
DDDDIIIISSSSPPPPLLLLAAAAYYYY to get the default host and display number.
PPPPAAAATTTTHHHH to find the executable to restart.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
XXXX(1), xxxxssssccccrrrreeeeeeeennnnssssaaaavvvveeeerrrr(1)
BBBBUUUUGGGGSSSS
Diagnostics are reported on the ssssttttddddeeeerrrrrrrr of the _x_s_c_r_e_e_n_s_a_v_e_r
process, not this process, so the caller of _x_s_c_r_e_e_n_s_a_v_e_r-
_c_o_m_m_a_n_d may not see the error messages.
CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
Copyright c 1992, 1993 by Jamie Zawinski. Permission to
use, copy, modify, distribute, and sell this software and
its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all
copies and that both that copyright notice and this
permission notice appear in supporting documentation. No
representations are made about the suitability of this
software for any purpose. It is provided "as is" without
express or implied warranty.
Page 2 (printed 6/30/95)
XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333)))) XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
AAAAUUUUTTTTHHHHOOOORRRR
Jamie Zawinski <jwz@mcom.com>, 13-aug-92.
Page 3 (printed 6/30/95)